home *** CD-ROM | disk | FTP | other *** search
/ IRIX Installation Tools & Overlays 2004 February / SGI IRIX Installation Tools & Overlays 2004 February - Disc 2.iso / relnotes / atm / ch2.z / ch2
Text File  |  2004-01-09  |  19KB  |  524 lines
  1.  
  2.  
  3.  
  4.                                   - 1 -
  5.  
  6.  
  7.  
  8.        2.  _I_n_s_t_a_l_l_a_t_i_o_n__I_n_f_o_r_m_a_t_i_o_n
  9.  
  10.        This chapter provides information about installing IRIS ATM
  11.        software. The information listed here is product-specific;
  12.        for general information about installing software, refer to
  13.        the _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _A_d_m_i_n_i_s_t_r_a_t_o_r'_s _G_u_i_d_e.
  14.  
  15.        The IRIS ATM product consists of a hardware component and a
  16.        software component. The hardware component is an IRIS ATM
  17.        board and associated items; the software is on the CD-ROM.
  18.        To install the IRIS ATM product, follow the procedures in
  19.        the overview below. The procedures must be followed in the
  20.        order they are listed.
  21.  
  22.          1.  Install the software, using the instructions in this
  23.              document in Section 2.2, ``Installing IRIS ATM
  24.              Software.''
  25.  
  26.          2.  Configure the software, using the instructions in the
  27.              _I_R_I_S _A_T_M _C_o_n_f_i_g_u_r_a_t_i_o_n _G_u_i_d_e.
  28.  
  29.              Note:  Do not configure IRIS ATM as the primary IP
  30.                     network interface.  IRIS ATM as a primary IP
  31.                     network connection is not supported in this
  32.                     release.
  33.  
  34.          3.  Have an authorized field service engineer install the
  35.              hardware using the field service document, _I_R_I_S _A_T_M
  36.              _I_n_s_t_a_l_l_a_t_i_o_n _I_n_s_t_r_u_c_t_i_o_n_s.
  37.  
  38.          4.  Verify the ATM connection, using the instructions in
  39.              the section ``Verifying the ATM Subsystem,'' in the
  40.              _I_R_I_S _A_T_M _C_o_n_f_i_g_u_r_a_t_i_o_n _G_u_i_d_e.
  41.  
  42.  
  43.  
  44.        2.1  _G_e_n_e_r_a_l__I_n_s_t_a_l_l_a_t_i_o_n__I_n_f_o_r_m_a_t_i_o_n
  45.  
  46.        This section contains general information about the IRIS ATM
  47.        software.  This information is useful during installation
  48.        and configuration.
  49.  
  50.        2.1.1  _A_T_M__N_e_t_w_o_r_k__I_n_t_e_r_f_a_c_e__N_a_m_e_s  During design, the
  51.        logical IP network interface for each controller board that
  52.        supports the IP network stack is given a name.  The ATM
  53.        network interface name is as specified below:
  54.  
  55.        _a_t_m#     Unlike many network products that support only one
  56.                 IP network interface for each physical port, IRIS
  57.                 ATM can support multiple IP network interfaces on
  58.                 each port.  The exact number of IP interfaces that
  59.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.                                   - 2 -
  70.  
  71.  
  72.  
  73.                 are assigned to each IRIS ATM board is
  74.                 configurable, as described in Chapter 3 of the _I_R_I_S
  75.                 _A_T_M _C_o_n_f_i_g_u_r_a_t_i_o_n _G_u_i_d_e.  There is no default
  76.                 configuration for IRIS ATM logical network
  77.                 interfaces. Each interface must be manually
  78.                 configured.
  79.  
  80.  
  81.        2.1.2  _I_R_I_S__A_T_M__S_u_b_s_y_s_t_e_m_s  Following is a description of
  82.        the IRIS ATM subsystems:
  83.  
  84.        _a_t_m._s_w._e_o_e                    IRIS ATM software: driver,
  85.                                      utilities, and miscellaneous
  86.                                      files.
  87.  
  88.        _a_t_m._s_w._d_e_v                    Files required for developing
  89.                                      upper-layer applications with
  90.                                      the IRIS ATM API.
  91.  
  92.        _a_t_m._s_w._i_l_m_i                   IRIS ATM ILMI software:
  93.                                      _a_t_m_i_l_m_i_d daemon.
  94.  
  95.        _a_t_m._s_w._s_i_g_d                   IRIS ATM Signalling software,
  96.                                      including the _a_t_m_s_i_g_d daemon.
  97.  
  98.        _a_t_m._m_a_n._e_o_e                   Manual pages for IRIS ATM
  99.                                      utilities. There are man pages
  100.                                      for atm(7M), if_atm(7M),
  101.                                      if_atmarp(7M), atmarp(1M),
  102.                                      atmconfig(1M), atmilmid(1M),
  103.                                      atmsigd(1M), atmstat(1M),
  104.                                      atmtest(1M), ifatmconfig(1M),
  105.                                      sigtest(1M), spansd(1M).
  106.  
  107.        _a_t_m._m_a_n._r_e_l_n_o_t_e_s              These release notes.
  108.  
  109.        _a_t_m._b_o_o_k_s                     Online documents that are
  110.                                      viewable with InSight.
  111.  
  112.  
  113.  
  114.        2.1.3  _I_R_I_S__A_T_M__S_u_b_s_y_s_t_e_m__D_i_s_k__S_p_a_c_e__R_e_q_u_i_r_e_m_e_n_t_s  This
  115.        section lists the IRIS ATM subsystems and their sizes.  All
  116.        subsystems are installed when you use the install atm and go
  117.        commands of _i_n_s_t.
  118.  
  119.        Note:  The listed subsystem sizes are approximate. Refer to
  120.               the _I_R_I_S _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _G_u_i_d_e for information
  121.               on determining exact sizes.
  122.  
  123.        Subsystem Name      Subsystem Size
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.                                   - 3 -
  136.  
  137.  
  138.  
  139.                            (1024-byte blocks)
  140.        _a_t_m._s_w._e_o_e                   532
  141.        _a_t_m._s_w._d_e_v                    68
  142.        _a_t_m._s_w._i_l_m_i                  372
  143.        _a_t_m._s_w._s_i_g_d                 2312
  144.        _a_t_m._m_a_n._e_o_e                   76
  145.        _a_t_m._m_a_n._r_e_l_n_o_t_e_s              28
  146.        _a_t_m._b_o_o_k_s                   1960
  147.  
  148.        2.1.4  _I_n_s_t_a_l_l_a_t_i_o_n__M_e_t_h_o_d  IRIS ATM does not include a
  149.        release of IRIX (the operating system), so the operating
  150.        system must already be installed.  IRIS ATM can be installed
  151.        without using the miniroot.
  152.  
  153.        Note:  After installation, the IRIS ATM driver will not
  154.               function until four additional steps are completed:
  155.               (1) the IRIS ATM software is configured, (2) the
  156.               board is installed, (3) the operating system is
  157.               rebuilt, by restarting the system or using the
  158.               _a_u_t_o_c_o_n_f_i_g command, and (4) the system is rebooted.
  159.  
  160.  
  161.        2.1.5  _C_o_n_f_i_g_u_r_a_t_i_o_n__F_i_l_e_s  The files listed below are used
  162.        by IRIS ATM software.  Some of these files must be edited
  163.        during initial installation and configuration; editing of
  164.        others is optional and may be done at any time for
  165.        customization of the environment. See the "_I_R_I_S _A_T_M
  166.        _C_o_n_f_i_g_u_r_a_t_i_o_n _G_u_i_d_e" for complete details.
  167.  
  168.        2.1.5.1  _O_r_i_g_i_n_/_O_n_y_x_2
  169.        /_v_a_r/_s_y_s_g_e_n/_m_a_s_t_e_r._d/_q_u_a_d_o_c_3:
  170.        File for configuring the character device interface.
  171.  
  172.        /_v_a_r/_s_y_s_g_e_n/_s_y_s_t_e_m/_q_u_a_d_o_c_3._s_m:
  173.        Instructions to _a_u_t_o_c_o_n_f_i_g when it is building the IRIS ATM
  174.        driver into the operating system.
  175.  
  176.        2.1.5.2  _C_H_A_L_L_E_N_G_E_/_O_n_y_x
  177.        /_v_a_r/_s_y_s_g_e_n/_m_a_s_t_e_r._d/_a_t_m:
  178.        File for configuring the character device interface.
  179.  
  180.        /_v_a_r/_s_y_s_g_e_n/_s_y_s_t_e_m/_a_t_m._s_m:
  181.        Instructions to _a_u_t_o_c_o_n_f_i_g when it is building the IRIS ATM
  182.        driver into the operating system.
  183.  
  184.  
  185.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.                                   - 4 -
  198.  
  199.  
  200.  
  201.        2.1.5.3  _G_e_n_e_r_i_c
  202.  
  203.        /_v_a_r/_a_t_m/_a_t_m_h_w._c_o_n_f:
  204.        File for configuring the IRIS ATM hardware.
  205.  
  206.        /_v_a_r/_a_t_m/_a_t_m_i_l_m_i_d._c_o_n_f:
  207.        File for configuring the IRIS ATM ILMI software.
  208.  
  209.        /_e_t_c/_c_o_n_f_i_g/_a_t_m_i_l_m_i_d._o_p_t_i_o_n_s:
  210.        File for setting optional runtime modes for the ILMI daemon.
  211.  
  212.        /_v_a_r/_a_t_m/_a_t_m_s_i_g_d._t_c_l:
  213.        File for configuring the IRIS ATM Signalling software.
  214.  
  215.        /_v_a_r/_s_y_s_g_e_n/_m_a_s_t_e_r._d/_i_f__a_t_m:
  216.        File for configuring the IP support in the IRIS ATM driver.
  217.        This file can be edited to enable/disable a number of _i_f__a_t_m
  218.        driver features.
  219.  
  220.        /_v_a_r/_s_y_s_g_e_n/_m_a_s_t_e_r._d/_i_f__a_t_m_a_r_p:
  221.        File for configuring SPANS support in the IRIS ATM driver.
  222.        This file can be edited to change _i_f__a_t_m_a_r_p driver features.
  223.  
  224.        /_v_a_r/_a_t_m/_i_f_a_t_m._c_o_n_f:
  225.        File for configuring address resolution server for each
  226.        logical IP subnetwork.
  227.  
  228.        /_v_a_r/_a_t_m/_p_v_c._c_o_n_f:
  229.        File for mapping IP addresses to VC addresses for PVCs.
  230.  
  231.        /_v_a_r/_a_t_m/_s_p_a_n_s_d._c_o_n_f:
  232.        File for specifying spand options (Origin and Onyx2 only).
  233.  
  234.  
  235.  
  236.        2.1.6  _F_i_l_e_s__T_h_a_t__A_r_e__I_n_s_t_a_l_l_e_d__B_u_t__D_o__N_o_t__N_e_e_d__T_o__B_e__E_d_i_t_e_d
  237.        The files listed below are installed as part of IRIS ATM,
  238.        however, they do not need to be edited at any time. These
  239.        files are required for proper operation of IRIS ATM.
  240.  
  241.        /_e_t_c/_i_n_i_t._d/_a_t_m:
  242.        Script that configures and starts each ATM port and the _a_t_m#
  243.        IP logical network interfaces.  The script also starts the
  244.        signalling and ILMI software. This script is called (via a
  245.        link, S28atm) from within the standard /_e_t_c/_r_c_2 multi-user
  246.        startup script.  This file should not be edited.
  247.  
  248.        /_e_t_c/_i_n_i_t._d/_n_e_t_w_o_r_k._a_t_m:
  249.        Script that initializes IP-over-PVC connections and address
  250.        resolution table.  This script is called from within the
  251.        standard /_e_t_c/_i_n_i_t._d/_n_e_t_w_o_r_k multi-user network startup
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.                                   - 5 -
  264.  
  265.  
  266.  
  267.        script.  This file should not be edited.
  268.  
  269.        /_u_s_r/_l_i_b/_n_e_t_v_i_s/_m_i_b_s/_a_t_m_f__i_l_m_i._m_i_b:
  270.        ATM MIB definition file. This file should not be edited.
  271.  
  272.  
  273.  
  274.        2.2  _I_n_s_t_a_l_l_i_n_g__I_R_I_S__A_T_M__S_o_f_t_w_a_r_e
  275.  
  276.        This section describes how to install IRIS ATM software.
  277.  
  278.        Before starting the installation, use the command below to
  279.        verify that IRIS ATM 2.1 (Origin) or ATM 1.0 (CHALLENGE) or
  280.        earlier is not installed.
  281.  
  282.        % versions atm
  283.  
  284.  
  285.        If the display indicates that IRIS ATM 2.1(Origin) or ATM 1.0 (CHALLENGE)
  286.        or earlier is installed,
  287.        use the command below to remove the software:
  288.  
  289.        # versions remove atm
  290.  
  291.        Caution: Failure to remove IRIS ATM 2.1 or earlier may
  292.               destroy the MAC address on your IRIS ATM network
  293.               controller (hardware).
  294.  
  295.        Otherwise, follow the instructions below to install IRIS
  296.        ATM.
  297.  
  298.        2.2.1  _P_r_e_r_e_q_u_i_s_i_t_e_s  Your system must be running IRIX
  299.        release 6.5. To verify the release your system is currently
  300.        running, use the command below:
  301.  
  302.        % versions eoe
  303.        I eoe   _d_a_t_e   Execution Only Environment 6.5
  304.  
  305.  
  306.  
  307.        2.2.2  _P_r_e_p_a_r_i_n_g__f_o_r__I_n_s_t_a_l_l_a_t_i_o_n
  308.  
  309.          1.  Use the "live" (non-miniroot) installation method, as
  310.              explained in chapter 4 of the ``_S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n
  311.              _A_d_m_i_n_i_s_t_r_a_t_o_r'_s _G_u_i_d_e.''
  312.  
  313.              There are four sources possible for installing the
  314.              IRIS ATM software: from a local peripheral device,
  315.              from a remote peripheral device, from a remote
  316.              Ethernet boot server (distribution directory), from a
  317.              local distribution directory. These methods are
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.                                   - 6 -
  330.  
  331.  
  332.  
  333.              summarized and explained in Chapter 4 of the _I_R_I_S
  334.              _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _G_u_i_d_e, where Table 4-1 provides
  335.              an excellent overview.
  336.  
  337.              Notes: ``Local'' refers to connecting the CD-ROM (or
  338.                     tape) player directly to the target system (the
  339.                     system onto which you are installing software).
  340.                     ``Remote'' refers to loading the software over
  341.                     the target system's Ethernet network connection
  342.                     using a CD-ROM (or tape) device connected to a
  343.                     different Ethernet station.
  344.  
  345.                     In order to install software from a remote
  346.                     distribution directory, your system must be
  347.                     physically connected to the Ethernet and it
  348.                     must have a functioning Ethernet connection.
  349.  
  350.          2.  Locate the following items:
  351.  
  352.              -    For installation from a peripheral device, locate
  353.                   the CD-ROM disk containing IRIS ATM software. If
  354.                   you specially ordered another medium (for
  355.                   example, tape), locate that item.
  356.  
  357.              -    For installation from a peripheral device, locate
  358.                   a device to play (read) the CD-ROM or tape. This
  359.                   device is not shipped with the IRIS ATM product;
  360.                   it belongs to your site.
  361.  
  362.              -    For installation from a distribution directory,
  363.                   determine the host name of the Ethernet station
  364.                   and the path to the directory.
  365.  
  366.          3.  Set up the installation hardware.
  367.  
  368.              -    If you are using a local device, follow the
  369.                   instructions in your system's owner's guide to
  370.                   connect the peripheral device.
  371.  
  372.              -    If you are using a remote device, follow the
  373.                   remote workstation or server's instructions for
  374.                   attaching peripheral devices.
  375.  
  376.              -    For installation from a distribution directory,
  377.                   verify that the IRIS ATM software has been loaded
  378.                   onto the station.  A section of the _S_o_f_t_w_a_r_e
  379.                   _I_n_s_t_a_l_l_a_t_i_o_n _A_d_m_i_n_i_s_t_r_a_t_o_r'_s _G_u_i_d_e provides
  380.                   instructions on preparing distribution
  381.                   directories.
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.                                   - 7 -
  396.  
  397.  
  398.  
  399.        2.2.3  _I_n_s_t_a_l_l_i_n_g__t_h_e__S_o_f_t_w_a_r_e  Use the live installation
  400.        method to install the IRIS ATM software (atm).  To install
  401.        the default subsystems, use the "_i_n_s_t_a_l_l _a_t_m" and "_g_o"
  402.        commands once you have invoked _i_n_s_t.  Step-by-step
  403.        instructions are provided in Chapter 4 of the _S_o_f_t_w_a_r_e
  404.        _I_n_s_t_a_l_l_a_t_i_o_n _A_d_m_i_n_i_s_t_r_a_t_o_r'_s _G_u_i_d_e.
  405.  
  406.        If you are not sure how to use _i_n_s_t, Chapter 5 in the
  407.        _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _A_d_m_i_n_i_s_t_r_a_t_o_r'_s _G_u_i_d_e provides
  408.        details.
  409.  
  410.        When you have finished installing the new software, follow
  411.        the steps in the _I_R_I_S _A_T_M _C_o_n_f_i_g_u_r_a_t_i_o_n _G_u_i_d_e to configure
  412.        the IRIS ATM subsystem.
  413.  
  414.        2.3  _C_o_n_f_i_g_u_r_i_n_g__a__D_i_s_k_l_e_s_s__S_t_a_t_i_o_n
  415.  
  416.        A diskless IRIS ATM station must be configured in accord
  417.        with the guidelines in this section.
  418.  
  419.          1.  The station must have either two network interfaces
  420.              (an Ethernet from which to boot and the ATM) or a
  421.              local CD-ROM player from which to boot and an ATM
  422.              interface.  The remaining text and guidelines apply
  423.              only to stations that boot over an Ethernet.
  424.  
  425.              A diskless workstation (client) must boot (from its
  426.              server) over its primary Ethernet connection, hence,
  427.              the diskless  ATM station must have both Ethernet and
  428.              ATM connections.  Use the command below to display the
  429.              station's network interfaces, then verify that one of
  430.              the IP addresses in the display is for the Ethernet
  431.              local area network attached to the _e_t_0 interface:
  432.              % /usr/etc/netstat -in
  433.  
  434.          2.  The _n_e_t_a_d_d_r value in NVRAM must be an Ethernet IP
  435.              address.
  436.  
  437.              The station's PROM must use the Ethernet connection
  438.              for booting over the network. To verify that the
  439.              system's PROM can access the Ethernet network, use the
  440.              commands below.  The values for _n_e_t_a_d_d_r and _i_n_e_t must
  441.              match.
  442.              % /etc/nvram netaddr
  443.              _x_x_x._x_x_x._x_x_x._x_x_x
  444.              % /_u_s_r/_e_t_c/_i_f_c_o_n_f_i_g _e_t_0
  445.               . . .
  446.                  _i_n_e_t _x_x_x._x_x_x._x_x_x._x_x_x  . . .
  447.  
  448.          3.  Ethernet must be configured as the primary network
  449.              interface.
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.                                   - 8 -
  462.  
  463.  
  464.  
  465.              Once the PROM has loaded the miniroot (bootstrap
  466.              kernel) from the boot server, control is passed to the
  467.              miniroot. At this point, the diskless client is known
  468.              to the boot server by the IP address in the NVRAM. If
  469.              this address were to change at this point, the server
  470.              would become confused and the boot process would not
  471.              complete. The best and easiest way to prevent this
  472.              from happening is to configure Ethernet (and build the
  473.              miniroot with Ethernet) as the primary network
  474.              interface.
  475.  
  476.              To verify that Ethernet is configured as the primary
  477.              network interface and ATM is another, use the commands
  478.              below:
  479.              # /bin/grep if1name /etc/config/netif.options
  480.                 <the display should be if1name=et0 or : if1name= >
  481.              # /bin/grep atm /etc/config/netif.options
  482.                 <the display should be if#name=atm##>
  483.  
  484.              The next kernel build (for example, _a_u_t_o_c_o_n_f_i_g) will
  485.              create an operating system in which Ethernet is the
  486.              primary interface.
  487.  
  488.        Note:  Once the miniroot is in control, the booting
  489.               procedure is completed using NFSr over the network
  490.               interface that the station's route daemon indicates
  491.               is the shortest path to the boot server.
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.